Skip to content

docs: move organization practices into guides#29331

Merged
mnkiefer merged 2 commits intomainfrom
copilot/move-org-practices-under-guides
Apr 30, 2026
Merged

docs: move organization practices into guides#29331
mnkiefer merged 2 commits intomainfrom
copilot/move-org-practices-under-guides

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 30, 2026

This updates the docs IA so Organization Practices lives under Guides instead of as a top-level section. The change aligns sidebar structure, content paths, and legacy URL handling around the new location.

  • Navigation

    • Moves the Organization Practices group into the Guides sidebar section in docs/astro.config.mjs
    • Preserves the existing page hierarchy under that group:
      • Overview
      • Safe Rollout
      • Sharing Workflows

  • Content paths

    • Relocates the section index and child pages to docs/src/content/docs/guides/organization-practices/
    • Keeps canonical page URLs under /guides/organization-practices/...

  • Redirect compatibility

    • Retains redirects from the previous /organization-practices/... paths to the new /guides/organization-practices/... routes
{
  label: 'Organization Practices',
  items: [
    { label: 'Overview', link: '/guides/organization-practices/' },
    { label: 'Safe Rollout', link: '/guides/organization-practices/safe-rollout/' },
    { label: 'Sharing Workflows', link: '/guides/organization-practices/sharing-workflows/' },
  ],
}

@mnkiefer
docs: move organization practices under guides
ac2ca65 
Agent-Logs-Url: https://github.com/github/gh-aw/sessions/05e5c5c1-e886-4909-8fe0-a8fb77694e51

Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
@mnkiefer mnkiefer marked this pull request as ready for review April 30, 2026 14:30
Copilot AI review requested due to automatic review settings April 30, 2026 14:30
Copilot AI reviewed Apr 30, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Moves the Organization Practices documentation section under Guides, aligning the sidebar IA, content paths, and redirects with the new location.

Changes:

  • Relocates Organization Practices docs to docs/src/content/docs/guides/organization-practices/ (overview + child pages).
  • Updates Starlight sidebar to nest the Organization Practices group under the Guides section.
  • Adds redirects from legacy /organization-practices/... routes to /gh-aw/guides/organization-practices/....
Show a summary per file
File Description
docs/astro.config.mjs Moves nav group under Guides and adds legacy-path redirects to the new Guides routes.
docs/src/content/docs/organization-practices/index.mdx Removes the old top-level Organization Practices landing page from the previous location.
docs/src/content/docs/guides/organization-practices/index.mdx Adds the Organization Practices landing page at the new Guides location.
docs/src/content/docs/guides/organization-practices/safe-rollout.md Adds the Safe Rollout guide page under the new section path.
docs/src/content/docs/guides/organization-practices/sharing-workflows.md Adds the Sharing Workflows guide page under the new section path.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 3/5 changed files
  • Comments generated: 1

Comment thread docs/src/content/docs/guides/organization-practices/index.mdx Outdated
@mnkiefer
Potential fix for pull request finding
776ad3a 
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@github-actions github-actions Bot mentioned this pull request Apr 30, 2026
Open
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 30, 2026

✅ smoke-ci: safeoutputs CLI comment + comment-memory run (25171493173)

Generated by Smoke CI for issue #29331 · ◷

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 30, 2026

Comment Memory

CI lights the path
Green checks bloom at dawn
Quiet bots still sing

Note

This comment is managed by comment memory.

It stores persistent context for this thread in the code block at the top of this comment.
Edit only the text inside the backtick fences; workflow metadata and the footer are regenerated automatically.

Learn more about comment memory

Generated by Smoke CI for issue #29331 · ◷

@mnkiefer mnkiefer changed the title Move Organization Practices docs under Guides docs: move organization practices into guides Apr 30, 2026
@mnkiefer mnkiefer merged commit 1d900a4 into main Apr 30, 2026
46 checks passed
@mnkiefer mnkiefer deleted the copilot/move-org-practices-under-guides branch April 30, 2026 14:42
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 30, 2026

Visual Regression Check

⚠️ Unable to capture screenshots — the sandbox network firewall blocks all outbound connections, including localhost:4321 and host.docker.internal:4321, so Playwright cannot reach the dev server.

PR Summary (static analysis)

This PR restructures documentation navigation by moving the Organization Practices section from a top-level sidebar group into Guides → Organization Practices:

File Change
docs/astro.config.mjs Sidebar nav entry moved under Guides; redirect rules added
docs/src/content/docs/guides/organization-practices/index.mdx New overview page (added)
docs/src/content/docs/guides/organization-practices/safe-rollout.md Renamed/moved
docs/src/content/docs/guides/organization-practices/sharing-workflows.md Renamed/moved
docs/src/content/docs/organization-practices/index.mdx Removed (old location)

Redirect rules for old URLs are present in astro.config.mjs, so existing links should continue to resolve.

Visual / Accessibility Check Status

Page Mobile (375×812) Tablet (768×1024) Desktop (1440×900) A11y
All pages ❌ Could not reach server ❌ Could not reach server ❌ Could not reach server ❌ Could not reach server

To run this check manually:

cd docs && npm run dev
# then run Playwright against (localhost/redacted)

Generated by Visual Regression Checker for issue #29331 · ● 326.6K · ◷

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

Assignees

@mnkiefer mnkiefer

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@mnkiefer